User: Validate Data
Validate Data (VALDATA via script) is a Node-level command that triggers the service to validate data for each eligible device or station the command resolves to, within a specified date/time range.
Devices or stations (gas meter Device Nodes, liquid Device Nodes with support for liquid periodic data, or station Group Nodes) are eligible if the following apply.
- Their device record is set to "active"
- The associated device record in the DDS is enabled
- The user executing the command has the appropriate security access
- There is data in the specified time range
- The time range specified is after the device installation date
The data to be validated is configurable by defining a date range via the command parameters. When the command is run, existing exceptions within the specified time range will be closed, so that new exceptions will be generated based upon the currently utilized validation rules.
You must have proper security authorization to execute this command. See FMS Security (and CMDSYS security event) for information about configuring security access for FMS commands.
See Viewing Command Logs for information about accessing historical logs for this command.
See Validation in the CygNet Measurement Concepts section, and Managing Validation Engines for more information about validating data.
See Configuring Validate Data Commands and Running Node Commands for more information about using this command via FMS Explorer.
See Scheduling FMS Command Tasks in the MSS for more information about scheduling commands.
See FMS ActiveX Controls and CxHmiFms for more information about using commands via FMS ActiveX controls on CygNet Studio or CygNet Vision screens.
See CxFms for more information about scripting commands.
Command Definition Properties
The following command definition properties apply to Validate Data commands, when scheduling, creating, or editing commands via CygNet Explorer.
| Property | Description |
|---|---|
|
FMS service |
Select a Site.Service for the command from the available FMS service list in the drop-down menu. |
|
Command |
Select the desired Command name from the drop-down menu. See FMS Commands for more information about available command types. |
|
Time format |
Select the desired Time format for the command from the drop-down menu. Options are as follows.
Default value is Device time. Notes: This parameter determines how the time window is selected in the database; not how the data is exported. For daily devices only, specifying start and end times of midnight (00:00:00), will always be interpreted as Contract time format, regardless of this selected parameter value. |
|
Priority |
Select a processing queue Priority for the command from the drop-down menu. Options from least to greatest priority are as follows.
Default value is Low level processing queue priority. |
|
Logging |
Select a Logging level for the command results from the drop-down menu. Options are as follows.
Default value is Low level logging when scheduling a command via the MSS in CygNet Explorer. Default value is High level logging when creating or running an ad-hoc command in FMS Explorer or via the FMS in CygNet Explorer. |
Command Parameters
The following command parameters apply to Validate Data commands, when scheduling, creating, or editing commands via CygNet Explorer or scripting.
Note: The actual validation engines used in implementing the command do not appear in this dialog box, as they are too complex to be shown in this format. Validation engines and their associated Nodes can be viewed and configured via the Validation button on the FMS Explorer Admin menu by users with proper security access. See Managing Validation Engines for more information.
| Parameter | Description | Type | Usage Notes |
|---|---|---|---|
|
SDateTime |
Start date/time |
DateTime |
Double-click to access the Select Start Date/Time dialog box. Select the starting date of the time range for which to validate data. See Selecting Date and Time for more information. See Note below this table. This parameter is required. |
|
EDateTime |
End date/time |
DateTime |
Double-click to access the Select End Date/Time dialog box. Select the ending date of the time range for which to validate data. See Selecting Date and Time for more information. See Note below this table. This parameter is required. |
Note: When using relative (rather than absolute) date/time, if both the start and end date/time have hour, minute, and second values of 00, or if both are set to midnight, an additional day will be added to the date at the end of the range. This occurs because the service assumes the start of the day for the starting date/time and the end of the day for the ending date/time in these circumstances. Therefore requesting a time range from T to T will yield one day of data, and from T-1 to T will yield two days of data. If only one day of data is desired when using relative date/time, the start and end date/times must therefore be the same. If any of the start or end date/time hour, minute, or second values are specified as a value other than zero (or midnight) however, the range will be used as specified.


